GC31-2513-0 
File No. $370/4300/8100/S34-00 


4700 Finance 
Communication System 
X.25 Custom Feature 
Description 

Systems RPQ 8V0134 


First Edition (June 1983) 


This manual provides programming and operating information for the 4700 Finance 
Communication System’s X.25 special feature RPQ 8V0134. This feature is supported 
by release 2 of the 4700 system. This manual supports that release, and applies to all 
subsequent releases and modifications until otherwise changed in new editions or 
Technical Newsletters (TNLs). 


Changes occur often to the information herein; before using this publication in 
connection with the installation or operation of IBM equipment, consult the latest JBM 
System/370 Bibliography of Industry Systems and Application Programs, GC20-0370, 
for the editions that are applicable and current. 


References in this publication to IBM products, programs, or services do not imply that 
IBM intends to make these available in all countries in which IBM operates. Any 
reference to an IBM program product in this publication is not intended to state or 
imply that only IBM’s program product may be used. Any functionally equivalent 
program may be used instead. 


Publications are not stocked at the address given below; requests for IBM publications 
should be made to your IBM representative or to the IBM branch office serving your 
locality. 7 


A form for reader’s comments is provided at the back of this publication. Address 
comments concerning the contents of this manual to IBM Corporation, Information 
Development, Department 78C, 1001 W.T. Harris Blvd., Charlotte, NC 28257, U.S.A. 
IBM may use or distribute any information you supply in any way it believes 
appropriate without incurring any obligation to you. 


©Copyright International Business Machines Corporation 1983 


What This Manual Contains 


This manual describes the 4700 Finance Communication Subsystem’s support for 
attaching to X.25-based packet-switched data networks. This support is called 
RPQ 8V0134. | 


Who Should Use This Manual, and How 


This manual is intended for those who install, test, program, operate, or 
maintain a 4700 system attached to a host over an X.25 network. It contains 
information primarily for configuring and programming such a system, and 
describes the following topics: 


Physical, link, and packet support provided 

X.25 facilities (call barring, closed user group support, and so on) 
Configuration and programming additions and changes 
Operator/4700 system monitor additions and changes 


If you are programming the system, this manual contains the theory, 
configuration (CPGEN), and instruction descriptions you need to use in addition 
to those in the 4700 Controller Programming Library. It also lists the statistical 
counters and error messages added by X.25. 


If you are installing the 4700 system, you should understand the storage 
allocation, data transfer (MABR) rate, added configuration macro instructions, 
and optional module descriptions in this manual before beginning the 
configuration process. | 


If you are operating a 4700/X.25 system, changes to the 4700 system monitor 
installation and operating procedures may be needed. A new system log message 
is also added. | 


If you maintain a 4700/X.25 system, you need the information about added 
statistical counters and diagnostics in the chapter on maintenance and 


diagnostics. 


This manual is a supplement to the information contained in the co-requisite 
publications listed on the following page. _ 


What This Manual Contains ili 


Other Information and Manuals You Will Need 


The following manuals contain information with which you should be familiar 
when programming or operating a 4700/X.25 system: 


Prerequisite Publications 


Before programming or operating a 4700/X.25 system, you should first 
understand the information in the IBM manual, X.25 Interface for Attaching 
IBM SNA Nodes to Packet-Switched Data Networks, General Information 
Manual, GA27-3345. 


Co-Requisite Publications 


The following publications, which this manual supplements, should be available 
to you when you program or operate a 4700/X.25 system: 
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IBM 4700 Finance Communication System: System Summary, GC31-2016 
IBM 4700 Finance Communication System Configurator, GC31-2017 | 


IBM 4700 Finance Communication System, Controller Programming 
Library, GBOF-1387. This manual refers to the six-volume library as the 4700 
Controller Programming Library, and at times to a specific volume, 
particularly Volume 3, Communication Programming (GC31-2068). 


IBM 4700 Finance Communication System, Subsystem Operating Procedures, 
GC31-2032, referred to by this manual as the 4700 Operating Procedures. 


IBM 4700 Finance Communication System, Subsystem Problem 
Determination Procedures, GC31-2033. This manual is referred to as the 
4700 Problem Determination Procedures. 


IBM Systems Network Architecture Format and Protocol Reference Manual: 
Architectural Logic, SC30-3112. | 
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Chapter 1. Application Programming Reference 


Introduction | 


This chapter briefly introduces X.25. for the 4700 system, and discusses changes 


or additions to the process of creating an application program when your system 
has an X.25 link. 


The International Telegraph and Telephone Consultative Committee (CCITT) 
Recommendation X.25 defines an interface between customer data terminal 
equipment (DTE) and data circuit-terminating equipment (DCE) to attach DTEs 
to packet-switched data networks (PSDN). The definition includes: 


e Physical level: The mechanical and electrical functions and procedures for 
starting, operating, and stopping DCE-DTE communication links. The 
4700/X.25 feature supports: 


- X.21 BIS leased circuit 

- X.21 leased circuit 

- ~ Line speed to 9.6 kilobits/second 
- Full duplex operation. 


e Link level: Access procedures for exchanging data over DTE-DCE 
communication links. The 4700/X.25 feature provides support for: 


- Link access protocol balanced (LAPB). 
- Modulo 8 link-level sequence numbering. 


© Packet level: Packet formats and control procedures for sending control 
information and data over DTE-DCE links. 


- Single virtual circuit, switched or permanent. 

- Modulo 8 or 128 packet level sequence numbering. 
- Data packet sizes of 64, 128, 256, and 512 bytes. 
- Packet window sizes 1 to 7 for modulo 8. 

- Packet window sizes 1 to 15 for modulo 128. 


The 4700 X.25 implementation adheres to the specifications found in The X.25 


Interface for Attaching IBM SNA Nodes to Packet-Switched Data Networks, 


General Information Manual, GA27-3345. 


| The 4700 X.25 interface simulates logical link control for adjacent SNA nodes 


with either of the following: 


@ = =§«Qualified Logical Link Control (QLLC) 


e Physical Services Header (PSH) 


You must define these and other X.25 operating characteristics with the link 
configuration macros or operating instructions described in Chapter 2. 
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The X.25 Network © 


Virtual Circuits 


Logical Channels 


Logical Link Control 


The network for a 4700 Finance Communication System dies using x. 25 
protocols includes a 4700 application program, a 4700 controller, the X.25 
network, a 3704/3705 communications controller or equivalent, a host system, an 
access method (such as VTAM), and a host application peat | 


The X.25 network provides a virtual circuit, identified by a logical channel, for 
data transfer. The IBM 4700 uses either Qualified Logical Link Control (QLLC) 
or Physical Services Header (PSH) protocols to control communications with a 
remote data terminal (DTE). 3 


A Permanent Virtual Circuit (PVC) is a logical point-to-point SDLC leased line. 
A Switched Virtual Circuit (SVC) is a logical point-to-point switched line. 


Each virtual circuit is assigned, by the PSDN, a logical chained group number (0 
to 15) and a logical channel number (0 to 255). Current X.25 support. limits the 
4700 to only one active virtual circuit at a time. The logical channel identifier, 
the group number plus the channel number, is defined to the 4700 in the 
X25LCHN macro. You can define the following types of logical channels: | 


Permanent channel 
Used for a PVC dedicated to data transfer Bcwien a 4700 and a specific 
DTE. 


Outgoing channel 
Used for an SVC where only the 4700 can initiate a call. 


Incoming channel 
Used for an SVC where only the remote DTE can initiate a call. 


Two-way channel 
Used for an SVC where either the remote DTE or the 4700 can initiate a call. 


QLLC protocols provide two levels of data transfer. Packets transmitted with the 
qualifier bit (Q-bit) off contain SNA/user data. Packets transmitted with the _ 
Q-bit on contain logical link control to perform adjacent node ee services 
such as XID, TEST, and DISC. 


PSH protocols contain a minimum two byte header to indicate the iccneat of the 
packet (data or adjacent node physical services). 
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Establishing Contact 


The X.25 network requires certain parameters to be passed to the X.25 DCE 
before communications can be established with a remote DTE. These parameters 
are defined to the 4700 through either the COMLINK, X25LCHN, X25CKT, and 
_ X25FAC configuration macros or in the start link (STRLNK) and start circuit 
(STRCKT) instruction parameters. 


Certain X.25 circuit information, such as the facility field of a call packet, are 
passed during call setup. The X.25 circuit information will be presented to the 
station whose program issued the STRCKT, or to the station specified during 
CPGEN to receive the information. This station is called the X.25 Circuit 
Information Station (X25CIS). 


Note: Contact during initial program load (IPL) considers the system monitor as 
the X25CIS. Any X.25 information passed at this time is written to the system 
log. 


Automatic Contact 


Contact with the remote DTE will be established automatically by the 4700 when 
a STRLNK instruction is issued and the following conditions are met: 


‘1. The circuit is a PVC. 


2. The circuit is specified, via CPGEN or a prior STRCKT, to be svicmetially 
started. 


The station’s program must then issue a STRCKT instruction, using the | 
parameters specified in the CPGEN macros or changed by a previous STRCKT. 
GMSILRM (X‘40’) is set in GMSIND when the connection is established. 


An 11 006 message containing cause and Sidenosic codes is written to the log if | 
a failure occurs during contact. 


Application Program Contact 


If your operation requires an incoming call or outgoing call SVC, if you must 
change a configured or previously changed STRCKT parameter, or if you require 
flow control or throughput class negotiations, you must follow a STRLNK 
instruction with a STRCKT instruction. | 


Successful completion of STRLNK (GMSILR set to 1) occurs when the link has 
been initialized and the restart procedure has been completed for the packet level. 
Failure of the STRLNK results in an 11 006 message, containing the cause and 
diagnostic codes, to be written to the log. 


Final connection is made with the remote DTE by issuing the STRCKT 
instruction. Flow control parameters and/or throughput class parameters, if 

_ specified in the configuration or in the STRCKT instruction, are included in the 
call request packet for an outgoing call SVC or in the call accepted packet for an 
incoming call SVC. The controller sets SMSCST to X‘04’ (SMSCCRM) for all 
stations configured for the link when connection is established. Failure of the 
STRCKT results in an 11 006 message, containing the cause and diagnostic codes, 
to be written to the log. | 
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Connection With a PVC 


If you specify an automatic start circuit, the controller sets GMSILR to 1 to 


indicate successful connection with a PVC. Connection to a PVC when automatic 
start circuit is not specified is indicated by setting GMSILR to 1 when the 
STRLNK instruction completes successfully and setting SMSCCR to 1 when the 
STRCKT instruction completes successfully. Failure of STRCKT, in either case, 
causes the controller to write an 11 006 message containing the cause and 


diagnostic codes in the log. 


SVC wa Calling Connection 


SVC — Called Connection 


If you select an outgoing call or two-way channel, you must establish the remote 
DTE connection by issuing the STRCKT instruction after STRLNK completes; 
GMSILR is set to 1. The controller then transmits a ‘Call Request’ packet 
containing optional X.25 facilities passed in either the STRCKT instruction or 
specified during configuration. Successful completion of the STRCKT instruction 
(SMSCCR set to 1) occurs when the controller receives a ‘call connected’ packet. 
The facility field of the call connected packet is presented to:'the X25CIS. If the 
received facility field is unacceptable to the X25CIS, the program must issue 
STPCKT to disconnect the virtual circuit. Any connection failure writes an 

11 006 message containing the cause and diagnostic codes in the system log. 


The user can select an incoming call channel or a two-way channel, and may 
want the remote DTE to establish connection. In this case, the application 
program waits following successful completion of STRLNK (GMSILR set to 1) 
for an ‘incoming call’ packet. The X25CIS receives the ‘incoming call’ packet, 
analyzes the Facility field of the call packet and, if acceptable, issues the 


STRCKT instruction. The X25CIS rejects the call by issuing STPCKT if the 


packet is not acceptable. A ‘call accepted’ packet, containing X.25 Facility 


parameters specified in the STRCKT- instruction and/or via the CPGEN, is 


transmitted. Successful connection is indicated by SMSCCR set to 1. 


Any connection failure results in an 11 006 message, containing the cause and ~ 
diagnostic codes, to be written to the log. | 


Compatability of Existing Application Programs 


Existing application programs for TYPE = 4502 (SDLC/ SNA) leased line operate 
unchanged only for an X.25 permanent virtual circuit (PVC) when you specify 
automatic start circuit. You must add a STRCKT instruction to other programs. 


Application programs required to support PVC that currently support 


TYPE = 4850 or 5656, must have all STRLNK instructions changed. 
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Timers 


Application programs required to support a switched virtual circuit (SVC) must 
be modified to provide the following functions: 


. Detect a link operational condition (GMSILR). 

. Issue a STRCKT instruction. 

Analyze return codes from a STRCKT. 

Detect a circuit operational condition (SMSCCR). 

. Analyze CALL ACCEPTED data (for Outgoing Calls). 

. Analyze INCOMING CALL data (for Incoming Calls). 

. Analyze flow control negotiations (if required). 

. Analyze facility fields Gf required). 

. Provide restart capabilities on a loss-of-contact condition. 
. Issue STPCKT, if necessary. 


SOAnNnANAF WN 
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X.25 defines the following timers and actions taken when the defined times 
expire: 


T20 thru T23 
These timers are started when a restart request, call request, reset request, or 
clear request is transmitted. The response to the request must arrive before 
the time expires or both the link and circuit stop. These timers expire at 200 
seconds. 


You must define the following timeout controls on the COMLINK configuration 
(CPGEN) macro before using X.25: 


Response timeout (RSPT) 
This specifies the most time that can elapse between the transmission 
of a frame and the receipt of the corresponding response. The timeout 
starts after the controller transmits each frame. If the timeout expires 
before the DCE acknowledges receipt of the frame, the 4700 transmits an 
RR frame with the poll bit on, forcing a DCE response indicating 
whether or not it received the previous frame. If it was not 
received, the controller resends the frame. Specify increments of 0.1 seconds. 
The default is 30 (3.0 seconds). | | | 


Idle/non-productive line (INPT) 
This defines the number of seconds that the line can remain idle with no 
complete frames received before the controller requests a DCE response. If 
the request produces no response from the DCE, the controller stops the link 


and circuit and posts loss-of-contact status. Specify increments of 5 seconds. 
The default is 4 (20 seconds). 


Retransmission value (REXM) 
This count defines how often the controller can resend a frame before 
disconnecting and reporting loss-of-contact. The default is 2 (two 
retransmission attempts). 


Connection timeout (OPTM) 
This specifies the time that the 4700 will wait for a link connection to be 
established before ending the connection attempt. Specify 13-second 
increments. The default is 1 (13 seconds). 


For more information on the X.25 configuration macro instructions and 
requirements, refer to ‘‘Configuration Macro Instructions.”’ 
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Packet Types 


— Call Request (SVO©) 


Incoming Call (SVC) 


Call Accepted (SVC) 


Call Connected (SVC) 


Clear Request (SVC) 


Clear Indication (SVC) 


The following describes each of the X.25 packet types supported by the 4700. 


The call request packet is transmitted by the 4700 when a STRCKT instruction is 
issued specifying an ‘outgoing call’. This packet contains the called and, 
optionally, the calling numbers, network facilities subscribed to by the 4700 user, 
and the Connection Identifier (CID). 


This packet is received by the 4700 as a result of a remote DTE transmitting a 
call request. The X25CIS is presented with the data contained in the packet 
when an LREAD is issued, the Read Type field (SMSCRT) is set to X‘B1’. 
Acceptance of the call is indicated by issuing the STRCKT instruction. To reject 
the call, a STPCKT is issued. 


This packet is sent from the 4700 as a result of a STRCKT instruction being 
issued after receipt of an incoming call. If so specified via the CPGEN or a prior 
STRCKT, the called and calling numbers and network facilities subscribed to by 
the user are contained in the packet. 


The call connected packet is received by the 4700 confirming that the remote 
DTE has accepted the ‘call request’. The X25CIS is presented with the data 
contained in the packet when an LREAD instruction is issued. The Read Type 
field (SMSCRT) is set to X‘B2’. The channel is now in the ‘data transfer’ state 
and SNA protocols may begin. 


This packet is sent when a STPCKT instruction is issued. The diagnostic code 
specified in the instruction, selected from those codes listed in the DTE generated 
diagnostic code section, will be included in the packet. 


Certain X.25 errors such as sequence errors, invalid packets, etc., will cause a 
clear request to be sent from the 4700. The circuit is stopped, an 11 006 message, 
containing the cause and diagnostic codes, is written to the log, and loss-of- 
contact status is posted to all stations using the circuit. A STRCKT instruction is 
required to re-open the circuit. 


This packet is received by the 4700 as a result of problems detected by the 
network or the remote DTE, or via a normal clearing sequence. The circuit is 
stopped, a clear confirmation is sent, and all stations using the circuit are posted 
with loss-of-contact status. An 11 006 message, containing the cause and 
diagnostic codes, is written to the log. A STRCKT instruction is required to re- 
open the circuit. 
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Clear Confirmation (SVC) 


Reset Request (PVC) 


Reset Indication (PVC) 


Reset Confirmation (PVO) 


Restart Request 


Restart Indication 


Restart Confirmation 


Data 


Clear confirmation is sent by the 4700 whenever a clear indication is received. 


This packet is sent when a STPCKT instruction is issued. The diagnostic code 
specified in the instruction, selected from those codes listed in the DTE generated 
diagnostic code section, will be included in the packet. 


Certain X.25 errors such as sequence errors, invalid packets, etc., will cause a 
reset request to be sent from the 4700. The circuit is stopped, the reset request 
sent, and all stations using the circuit are posted with loss-of-contact. An 11 006 
message containing the cause and diagnostic codes, is written to the log. A 
STRCKT is required to re-open the circuit. 


This packet is received by the 4700 as a result of problems detected by the 
network or the remote DTE. The circuit is stopped, and loss-of-contact status 
posted to all stations using the circuit. An 11 006 message, containing the cause 
and diagnostic codes, is written to the log. A STRCKT is required to re-open the 
circuit. 


Reset confirmation confirms that the circuit has been reset. Reset confirmation is 
sent by the 4700 whenever a reset indication is received. 


This packet is sent when a STRLNK or STPLNK instruction is issued as part of 
the restart procedure. | 


Certain X.25 errors occurring at the packet level will also cause a restart request 
to be sent from the 4700. The circuit is stopped, an 11 006 message containing 
the cause and diagnostic codes is written to the log, and all stations using the 
circuit are posted with loss-of-contact status. A STRLNK is required to re- 
establish communications. 


This packet is received by the 4700 and indicates that the link has been restarted. 
Loss-of-contact status is posted to all stations using the circuit and an attempt is 
made to re-establish communications. 


Restart confirmation is received by the 4700 in response to a restart request and 
sent by the 4700 whenever a restart indication is received. 


This packet sent/received by the 4700 and contains user data. 
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Receiver Not Ready (RNR) 


Receiver Ready (RR) 


Diagnostic 


X.25 Facilities 


—" 


This packet will not be sent by the 4700. If an RNR is received, the 4700 will 
stop transmission of data packets until an RR is received. 


This packet is sent by the 4700 in response to a data packet received unless an 
outgoing data packet is available for transmission. Receipt of an RR packet 
indicates that transmission from the 4700 may resume. 


This packet is received by the 4700 from the DCE and contains error indication 
data where the usual method of reporting, Reset, Clear or Restart packets, are 

not appropriate. This information is written to the log and no further action is 

taken. | | 


Optional X.25 Facilities are requested from network administration by 
subscription or, for those facilities that can be specified in call packets, specified 
via CPGEN or by parameters passed in the STRLNK and STRCKT 

instructions. : 


The following facilities are subscribed to from the Network Administrator and 
require no support from the 4700. 


. Incoming calls barred 

. Outgoing calls barred 

. Closed user group (CUG) with outgoing access 
. CUG with incoming access 

. Incoming calls barred in CUG 

. Outgoing calls barred in CUG 

. Reverse charge acceptance. 


SIAM HBWN = 


The following facilities are subscribed to from the Network Administrator and 


_ require support from the 4700 via the CPGEN and/or the controller application 


program for inclusion in Call packets: 


. One-way logical channel-outgoing 

. One-way logical channel-incoming 

. Extended packet sequence numbering 

. Non-standard default window sizes 

. Default throughput classes assignment 

Closed user group 

. Reverse charging 

. Recognized private operating agency (RPOA) . 
. Flow control parameter negotiation 

. Throughput class negotiation. 


OwowontnanawnPFwnre 
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Extended Packet Sequence Numbering 


Selects modulo 128 sequence numbering of packets instead of the default, 
modulo 8. ; 


Incoming Calls Barred 


Prevents incoming calls from remote DTEs. A call request must be sent by the 
4700 to establish communications. 


Outgoing Calls Barred 


Prevents 4700 call requests from entering the network. An incoming call is 
needed to establish communications. 


One-Way Logical Channel Out 


Restricts the logical channel use to originating call requests. Incoming calls are 
not allowed. 


One-Way Logical Channel In 


Restricts the logical channel use to receiving incoming calls. Call requests are not 
allowed. 


Closed User Group (CUG) 


Specifies that the 4700 is a member of a closed user group (CUG). 
Communications can occur only among members of the group. 


CUG with Outgoing Access 


Allows the 4700 to send a call request to DTEs outside of the CUG. 
CUG with Incoming Access 
Allows incoming calls from DTEs outside of the CUG. 


Incoming Calls Barred in CUG 


Prevents incoming calls from members of the CUG. The 4700 may make call 
requests to members of the CUG. 


Outgoing Calls Barred in CUG 


Prevents the 4700 from sending call requests. The remote DTE must transmit an 
incoming call before communication is established. 
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Reverse Charging 


Request that the called DTE accept all charges for the call. The reverse charging 
information received in the call request is analyzed by the called DTE and if 
acceptable a call accepted is sent, otherwise a clear request is sent. 


Reverse Charging Acceptance 


This facility specifies that the network transmit to the 4700 incoming calls that 
request reverse charging. : 


Recognized Private Operating Agency (RPOA) 


Allows you to select the intermediate network (RPOA) to be used between two 
public networks. | 


Flow Control Parameter Negotiation 


Specified by the FCPN operand of the X25CKT macro or in the STRCKT 
instruction, permits negotiation of packet and window sizes. The values received 
in the call connected packet on an outgoing call SVC or sent in the call accepted 
packet on an incoming call SVC used for the remainder of the call. The 
application program can issue a STPCKT instruction if the parameters are not 
acceptable; the controller does not check the parameters. 


Packet-Size Negotiation 
The packet size specified in the STRCKT instruction or the X25CKT macro will 


be included in the facility field of a call request packet for an outgoing call SVC 
or in the call accepted packet for an incoming call SVC. 


Non-Standard Default Window Sizes 
The window size value will be included in the facility field of a call request 
packet for an outgoing call SVC or the call accepted packet for an incoming call 


SVC. 


Throughput Class Negotiation 


Specified in the THPTCL operand of the X25FAC macro or in the STRCKT 
instruction, permits negotiation of the throughput class. The values received in 
the call connected packet on an outgoing call SVC or sent in the call accepted 
packet on an incoming call SVC, will be used for the remainder of the call. The 
application program can issue a STPCKT instruction if the parameters are not 
acceptable. _ 


Throughput Class Assignment 


Specifies a selection of throughput classes from a list supported by the network. 
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Call Data Formats 


Incoming Call Data Format 


The data contained in an incoming call packet and presented to the application 


program has the following format: 


Bits 0 1 2 3 


Calling DTE 
Byte 0 Addr length 
(optional) 


Called DTE 
Addr length 


Called—Calling DTE Address | 


Byte 1—n (see note 1) 


Byte n+1 Facility Length 


Byte n+2—m Facilities 
(optional) 


Byte m+1—m+9 Call User Data Field 


(optional) 


Notes: 


(see note 2) 


1. Each address contains from 1 to 15 numbers, 2 digits to a byte. 
The figure is drawn assuming a single address consisting of an odd number 
of digits, padded with zeros to provide byte alignment. 

2. The first byte of the call user data field is set to X‘C3’ for QLLC and X‘C2’ 
for PSH. The next 8 bytes contain the connection identifier. 


Call Connected Data Format 


The data contained in a call connected packet and presented to the application 


program has the following format: 


Bits '¢] 1 2 3 


Calling DTE 
Byte 0 Addr length 
(optional) 


Called DTE 
Addr length 
(optional) 


Called—Calling DTE Address 


Byte 1—n (optional - see note) 


Byte n+1 Facility Length 
(optional) 
Byte n+2—m Facilities 


(optional) 


Note: Each address contains from 1 to 15 numbers, 2 digits to a byte. The 
figure assumes a single address consisting of an odd number of digits, and 
padded with zeros to provide byte alignment. 
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Facility Formats 


_ The facilities contained in the incoming call or call accepted data presented to the 


application program has the following format. 


Facility: Code: Field: 


CUG X ‘03’ One byte containing the two-digit index. 
Reverse X‘On’ One byte with the following bit meaning: 
Charging X‘00’: Reverse charging not requested. 


X‘01’: Reverse charging requested. 
RPOA X‘44’ Two bytes containing the four-digit Identification Code. 
Flow Control Parameter Negotiation: 
Packet X°42’ Two bytes coded in binary. The first byte contains the 
Size packet size of the called DTE. The second byte contains 

the packet size of the calling DTE. 
Window X°43’ Two bytes coded in binary. The first byte contains the 
Size window size of the called DTE. The second byte contains 

| the window size of the calling DTE. 
Throughput Class Negotiation: 
X ‘02’ One byte specifying the throughput class. 
Bits 0-3 contain the called DTE size. 
Bits 4-7 contain the calling DTE size. 


The hexadecimal codes listed above are fixed at the values shown by 4700 X.25 
support. , 


An example of a facility field is: 
X‘0311442222’ 


This field specifies a CUG of 11 (X‘03’) and an RPOA of 2222 (X‘44’). You can 
also specify the field as: 


X°4422220311’ 
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Chapter 2. Instructions and Macros 


This section contains descriptions of the X.25 instructions, configuration macro 
instructions, and the parameters required for X.25. 


4700 Assembler Instructions 


LCHECK CP 


LREAD CP 


LWRITE CP 


Start Circuit (STRCKT) 


The operation of the LCHECK instruction is the same as described in current 
4700 publications. 


The operation of the LREAD instruction is the same as described in current 4700 
publications with two additional Read types set in SMSCRT: 


e X‘BI’ — Incoming call packet. 


e X‘B2’ — Call connected packet. 


The operation of the LWRITE instruction is the same as described in current 
4700 publications. 


STRCKT activates an inactive virtual circuit. STRCKT can perform two 
functions: (1) return the current contents of parameters FLAGI, set to X‘FO’, 
through CID in the parameter list, or (2) control the automatic start circuit flag. 
STRCKT points to a 5 to 56 byte parameter list that describes the virtual circuit 
options and X.25 Facilities. The parameter list may be specified in 5 sections with 
section 1, the first 5 bytes, always required. The other sections are optional and 
the required CPGEN values will be used if not specified. 


Name Operation Operand 
label STRCKT — { defcon 
deflid 
defrf 
reg 
seg,disp 
defcon 


Is the label of a DEFCON instruction that defines the start of the parameter 
list. 


defld 


Is the label of a DEFLD instruction that defines the start of the parameter 
list. a 
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defrf 


Is the label of a DEFRF instruction that defines the start of the parameter 
list. : 


Le | 


eg E 
Is the register number that contains the address of the parameter list. 


2) 


eg 
Is the number of the segment that contains the parameter list. 


disp 
Is the location of the parameter list within the segment. 


Condition Codes: X‘01’ The instruction executed successfully. 


X‘02’ Status is returned; the status code is contained in 
SMSDST. 


Program Checks: 1 or 2 may be set. 


The parameter list formats are: 


FLAG1 FLAG2 FLAG3 _ LCHNI 


Byte O 1 2 3-4 


CONFG1 CONFG2 
n n+1 n+2/n+5_ 
m 


LOCLN LOCNM REMLN | REMNM 


m+1/m+15 m+16 m+17/m+31 


CUG RPOA THPTCL OFAC 


p p+i1/p+2 p+3 p+4 


q/q+7 


FLAG1 
A one-byte binary number that describes the parameter list. 


Bit: Definition: 


@) O=bytes n through n+5 are not present. 
1 =bytes n through n+5 are present. 


1 O=bytes m through m+ 31 are not present. 
1 =bytes m through m+ 31 are present. 


2 O=bytes p through p+ 4 are not present. 
1 =bytes p through p+4 are present. 


3 0 = bytes q through q+/7 are not present. 
1 =bytes q through q+ 7 are present. 


4-7 Reserved 
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FLAG2 
A one-byte binary number that describes the circuit parameters, 


Bit: Definition: 


0 O = start this circuit now without starting automatically in the future. 
1 start this circuit now, and automatically in the future (valid for PVC only). 


1 O = use default FLAG3 values (from GPGEN or previous STRCKT commands). 
1 = use specified FLAG3 values. 


2-5 Reserved 


6 | O = start the Circuit. 
= turn off the Automatic Start Circuit flag. 


— 
| 


7 O = start the Circuit. 
= return current contents of all parameters. 


= 
| 


If either bits 6 or 7 are on, the circuit does not start. 


FLAG3 
A one-byte binary number that describes the inclusion of fields in call 
packets. 
Bit: Definition: 
O O = do not include flow control negotiation parameters in the call packets. 
1 = include flow control negotiation parameters in the call packets. 
1 O = do not include LOCNM in the call! packets. 
1 = include LOCNM. 
2 O = do not include REMNM in the call accepted packet. | 
1 = include REMNM. 4700 requires this bit for outgoing calls. 
3 O = do not include CUG in the call packet. 
1 = include CUG. 
4 O = do not include RPOA in the call packets. 
1 = include RPOA. 
5 O = do not include THPTCL in the call packet. 
1 = include THPTCL. 
6 O = do not include OFAC in the call packet. 
1 = include OFAC. 
7 O = do not include CID in the call packet. 
1 = include CID. 
LCHNI 


A 2-byte field containing a 12-bit, right-justified, binary number that 
specifies the logical channel group number (0 to 15) and the logical channel 
number (0 to 255). This parameter is ignored if an incoming call has been 
received. 
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CONFGI1 
A one-byte binary number that specifies the packet size, LLC, and type of 
circuit; switched or permanent. Absence of this parameter, or a value of 
zero, indicates that the current settings are to be used. 


Note: The instruction will complete with X‘0401’ status if the packet size is 
greater than that specified in the X25CKT CPGEN instruction. 


Bit: Definition: 


nyo 


00 = 128 10 = 256 O1 = 64 11 = 512 


Reserved 
1 = Permanent O = Switched 


10 = PSH 11 = QLLC 


Reserved 
Reserved 


NO OP WD — © 
=e 


CONFG2 
A one-byte binary number that specifies the type of switched call and 
window size. Absence of this parameter, or a value of zero, indicates that the 
current settings are to be used. 


Note: The instruction will complete with. X‘0402’ status if the window size is 
specified greater than 7 and the modulo is specified as 8. 


Bit: Explanation: 

0 O = Outgoing call 1 = Incoming call 
1 Reserved 
2 Reserved 

3 Reserved 

4 Window size 

5 X‘1' to X‘7’ if modulo 8 specified 

6 X‘1' to X‘F’ if modulo 128 specified 
7 Reserved 

LOCLN 


A one-byte binary number, in the range of 0 to 15, that specifies the decimal 
number length of the calling DTE number (LOCNM). Absence of this 
parameter, or a value of zero, indicates that the current values are to be used 
in the call accepted and call request packets. 


LOCNM | 
A 15-byte field containing the calling DTE number, left justified. 


REMLN 
A One-byte binary number, in the range of 0 to 15, that specifies the decimal 
number length of the called DTE number (REMNM). Absence of this 
parameter, or a value of zero, indicates that the current values are to be used 
in the call accepted packets. 


REMNM 
A 15-byte field containing the called DTE number, left justified. 
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CUG | 
A one-byte hexadecimal number specifying the two-digit group code. 
Absence of this parameter, or a value of zero, indicates that the current 
value is to be used. 


RPOA 
A two-byte hexadecimal number specifying the four-digit number of the 
intermediate network. Absence of this parameter, or a value of zero, 
indicates that the current value is to be used. 


THPTCL | 
A one-byte binary number specifying the throughput class. Absence of this 
parameter, or a value of zero, indicates that the current value is to be used. | 


DCE to 4700: 4700 to DCE: HEX 
Bits 012 3 4567 

00 1 1 75 001 1 3 
0100 150 0100 4 
010 1 300 010 1 5 
0110 600 O11 0 6 
O11 17 1200 O11 1 7 
1000 2400 1000 8 
100 1 4800 100 1 9 
101 0 9600 101 0 A 


OFAC | 
A one-byte binary number specifying the optional facilities requested. 
Absence of this parameter indicates that the current value is to be used. 


Bit: Optional Facility: 

0-6 Reserved 

7 Reverse Charging 
CID 


An eight-byte field that contains the eight-character connection ID. This ID 
will be placed in the user data field of a call packet. Absence of this 
parameter indicates that the current value is to be used. 
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Stop Circuit (STPCKT) 


STPCKT deactivates an active virtual circuit. STPCKT points to a one-byte 
parameter list that provides a diagnostic code to be included in the clear request 
packet for an SVC, in the reset request packet for PVC, and in the restart 
request packet. | | 


Name Operation Operand 
label STPCKT defcon 
defld 
defrf 
reg 
seg,disp 
defcon 
Is the label of a DEFCON instruction that defines the start of the parameter 
list. 
defld | | 
Is the label of a DEFLD instruction that defines the start of the parameter 
list. | | 
defrf 
Is the label of a DEFRF instruction that defines the start of the parameter 
list. 
reg | 


_Is the register number that contains the address of the parameter list. 


seg ) 
Is the number of the segment that contains the parameter list. 


disp 
Is the location of the parameter list within the segment. 


Condition Codes: The code is not changed. 
Program Checks: 1 or 2 may be set. 


The parameter list format is: 


DIAG 


Byte O 


DIAG | 
A one-byte hexadecimal number specifying the DTE diagnostic code to be 
included in the call packet. See Chapter 3 for specific diagnostic codes. 


2-6 4700/X.25 Custom Feature Description 


Start Link (STRLNK) 


a) 


STRLNK activates an inactive communications link or returns the current | 
contents of parameters FLAG] through ICLCI in the parameter list. STRLNK 
points to a 7 or 19-byte parameter list that describes the link options and logical 
channel specifications. 


Name Operation . Operand 
label STRLNK defcon 
defld 
defrf 
reg 
seg,disp 
defcon 


Is the label of a DEFCON instruction that defines the start of the parameter 
list. 


defild 
Is the label of a DEFLD instruction that defines the start of the parameter 
list. 


defrf 
Is the label of a DEFRF instruction that defines the start of the parameter 
list. | 


reg , 
Is the register number that contains the address of the parameter list. 


seg 
Is the number of the segment that contains the parameter list. 


disp 
Is the location of the parameter list within the segment. 


Condition Codes: The code is not changed. 
Program Checks: 1 or 2 may be set. 
Parameter list format. 


FLAG1 FLAG2 CUA FLAG3 § XID 


Byte O 1 a) 4-6 


2 
INPT RSPT REXM OPTM PVCLCI 
7 8 9 10 11-12 


OCLCI — TWLCI ICLCI 


13-14 15-16 17-18 


Bytes 0, 1, 2, and 4-6 are the same for all communication links and are described 
in current publications. 
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FLAG3 _ | 
A one-byte binary number that describes the X.25 link parameters. 


Bit: Definition: 


0 Set to 1 if XID is present. 

1 Set to 1 if X.25 parameters follow. 

2 Set to 1 if UKPSS or TELENET network. 

3 Set to 1 for modulo 128 packet level sequence numbering. 
4 Set to 1 for a DDXP network. | 

5-6 Reserved. 

7 Return current parameter list contents. 


INPT | 

A One-byte binary number, in the range of 0 to 20, that specifies the 

_ idle/non-productive timeout value in five-second increments. Absence of this 
parameter, or a value of zero, causes the current value to be used. 


RSPT 
A one-byte binary number, in the range of 0 to 99, that specifies the 
response timeout value in increments of 0.1 seconds. Absence of this 
parameter, or a value of zero, causes the current value to be used. 


REXM 
A one-byte binary number, in the range of 0 to 99, that specifies the re- 
transmission retry count. Absence of this parameter, or a value of zero, 
causes the current value to be used. 


OPTM 
A one-byte binary number, in the range of 0 to 7, that specifies the 
connection establishment timeout value in 13-second increments. Absence of 
this parameter, or a value of zero, causes the current value to be used. 


PVCLCI 
A two-byte field that contains a 12-bit, right-justified, binary number that 
specifies the logical channel group number (0 to 15) and the logical channel 
number (0 to 255), of the channel reserved by the network for the PVC. 
Absence of this parameter causes the current value from either CPGEN or a 
previous STRLNK command to be used. 


OCLCI 

A two-byte field that contains a 12-bit, right-justified, binary number that 
specifies the logical channel group number (0 to 15) and the logical channel 
number (0 to 255), of the channel reserved by the network for outgoing calls. 
Absence of this parameter causes the current value from either CPGEN or a 
previous STRLNK command to be used. 

_TWLC!I | 

_ A two-byte field that contains a 12-bit, right-justified, binary number that 

specifies the logical channel group number (0 to 15) and the logical channel 
number (0 to 255), of the channel reserved by the network for two-way calls. 
Absence of this parameter causes the current value from either CPGEN or a 
previous STRLNK command to be used. 


ICLCI | 
A two-byte field that contains a 12-bit, right-justified, binary number that 
specifies the logical channel group number (0 to 15) and the logical channel 
number (0 to 255), of the channel reserved by the network for incoming 
calls. Absence of this parameter causes the current value from either CPGEN 
or a previous STRLNK command to be used. 
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Stop Link (STPLNK) 


- seg 


STPLNK immediately deactivates the communication link. STPLNK points to a 
parameter list; however, the parameters are neither used nor changed by | 
STPLNK. 


Name Operation Operand 
label STPLNK defcon 
defld 
defrf 
reg 
seg,disp 
defcon 7 
Is the label of a DEFCON instruction that defines the start of the parameter 
list. 
defld 


Is the label of a DEFLD instruction that defines the start of the parameter 
list. 


defrf | 
Is the label of a DEFRF instruction that defines the start of the parameter 
list. 

reg 
Is the register number that contains the address of the parameter list. 


Is the number of the segment that contains the parameter list. 


disp | 
Is the location of the parameter list within the segment. 


Condition Codes: The code is not changed. 


Program Checks: 1 or 2 may be set.. 
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Configuration Macro Instructions 


The configuration macros required during the CPGEN process, when X.25 is 
included in the 4700 system controller, are described in detail in this section. 


The syntax notation format used in describing the macros is, with the following 
exceptions, identical to the format used in the JBM 4700 Finance | 
Communications System Controller Programming Library, GBOF-1387. Operands 
which require specification of EBCDIC data may be coded directly without any 
data type identification, or in the form C‘operand’. Data to be expressed as 
hexadecimal must be specified in the form X‘operand’. 

The macros used by X.25 are: 

e COMLINK used to specify the characteristics of the network 

e X25LCHN used to specify the characteristics of logical channels 

e¢ X25CKT used to specify the characteristics of the circuit 


e X25FAC used to specify optional user facilities. 
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COMLINK 


This macro is used to specify the X.25 network characteristics and must be coded 
for X.25 operations. The operands discussed here are in addition to or 
modifications to existing operands. Network parameters specified in this macro 
may be altered with the STRLNK instruction. 


Name Operation Operand . | | 
label COMLINK TYPE =8V0134 (CNL = i (CNB = be ! 
128 3 
DDXP 
TELENET | 
*NETWORK = 4. Uxpss ,MODULO zi 28 
NORM 8 


|RSPT = far ia ta 


TYPE | 
Specify 8V0134 when operating with an X.25 link. 


CNL 
Is a decimal number, in the rangé 128 to 4084, that specifies the size of the 
controller read buffers in bytes. The read buffers must be as large as the 
largest message read from the communication link, and must be at least 128 
bytes. If unspecified, 128 is assumed. 


Note: A clear or reset packet is sent if a message is received that exceeds this 
value. 


CNB 
A decimal number, in the range 3 to 99, that specifies the number of 
controller read buffers. The minimum value is 3, also the default. 


NETWORK 
The name of the specific network that will be used. Currently, the network- 
specific processing required is for the DDXP, TELENET, and UKPSS 
networks. The default is NORM. 


MODULO | | 
A decimal number, 8 or 128, specifying the modulo to be used for packet 
level sequence numbering. The default is modulo 8. 


RSPT 
_ Response timeout value, a decimal number in the range of 1 to 99, 
represents the maximum allowable period of time that can elapse between the 
transmission of a frame and the receipt of the corresponding response. This 
time value is agreed upon with the Network Administration. RSPT is 
specified in 0.1-second intervals with a default of 30 (3 seconds). 
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INPT | 
Idle/non-productive timeout value, a decimal number in the range 1 to 20, 
represents the period of time, in 5-second increments, that the line can 
remain idle, no complete frames received, before the 4700 will transmit an 
RR frame soliciting a response from the DCE. If no response is received 
from the DCE, the link and circuit will be stopped and loss-of-contact status 
will be posted. The default is 4 or 20 seconds of idle state. 


REXM | | 
Retransmissions value, a decimal number in the range 1 to 99, specifies the 
number of times the 4700 will retransmit a frame, based on RSPT value, 
before terminating the connection and posting loss-of-contact. The default 
value is 2. | 


OPTM 
Connection establishment timeout value, a decimal number in the range 1 to 
7, specifies the time, in 13-second increments, that the 4700 will wait for the 
link connection to be established before aborting the connection attempt. The 
default is 1 or 13 seconds. 
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X2SLCHN 


This macro specifies the ID of all logical channels reserved by the network 
subscription, and must be coded for X.25 operations. Parameters specified in this 
macro can be changed with the STRLNK program instruction. 


Name Operation Operand 
label X25LCHN [ pveicl z (nn, mmm) | [ OCLC! =(nn,mmm, pp) ] 


[ .TWLCI=(nn,mmm,pp) | [ ICLCI=(nn,mmm,pp) | 


PVCLCI 
The logical channel group number (nn) and the logical channel number 
(mmm) of the channel reserved by the network for the permanent virtual 
circuit. nn is a decimal number in the range of 0 to 15; mmm is a decimal 
number in the range of 0 to 255. 


OCLCI 
The logical channel group number (nn) and the logical channel numbers 
(mmm) of the channels reserved by the network for outgoing call circuits. nn 
is a decimal number in the range of 0 to 15; mmm is a decimal number in 
the range of 0 to 255 that specifies the first logical channel number. pp is the 
decimal number in the range of 1 to 64 that specifies the number of logical 
channels to be defined (the LCNs must be sequential). 


TWLCI 
The logical channel group number (nn) and the logical channel numbers 
(mmm) of the channels reserved by the network for two-way call circuits. nn 
is a decimal number in the range of 0 to 15. mmm is a decimal number in 
the range of 0 to 255 that specifies the first logical channel number. pp is a 
decimal number in the range 1 to 64 that specifies the number of logical | 
channels to be defined (the LCNs must be sequential). 


ICLCI 
The logical channel group number (nn) and the logical channel numbers 
(mmm) of the channels reserved by the network for incoming-call circuits. nn 
is a decimal number in the range of 0 to 15. mmm is a decimal number in 
the range of 9 to 255 that specifies the first logical channel number. pp is a 
decimal number in the range 1 to 64 that specifies the number of logical 
channels to be defined (the LCNs must be sequential). 
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X25CKT 


This macro is used to specify the characteristics of an X.25 circuit and must be 
coded for X.25 operations. Parameters specified in this macro are included in the 
call packet and may be altered with the STRCKT instruction. 


Name 
/ 


Operand 


label = X25CKT . le i [-AuTo=(nyy] pute= (ese 1 


VIRT 


jem] Lm 


pres = ee | pepe = {o"}] 


[,LOCNM =nn ..n] [ REMNM =nn . n] 


[.CONID=nn Se n} [ .X25CIS=nn | 


Describes the type of virtual circuit subscribed, S for a switched virtual 
circuit and P for a permanent virtual circuit. If ‘S’ is specified, the CALL 
operand must be specified. The default is ‘P’, or a permanent virtual circuit. 


AUTO 


N requires a STRLNK followed by a STRCKT instruction to activate the 
circuit. Y, the default, specifies that this circuit 1s to be started automatically 
with existing parameters, when a STRLNK instruction is issued. This 
parameter applies to PVC only. SVC must be started via a STRCKT 


instruction. 


LLC 


Specifies the type of logical link control used. QLLC is the default. 


CALL 


Describes the type of call required for a switched circuit. O indicates an 
outgoing call (REMNM required) and I indicates an incoming call. This 
parameter must be specified if VIRT is specified as switched. 


FCPN 


Y specifies that flow control parameter negotiation has been subscribed and 
that the PKTSIZ and WINDOW values will be included in the facility field 
of the call packet. N, the default, specifies that the PKTSIZ and WINDOW 
values will not be included in the call packet. 


PKTSIZ 


A decimal number specifying the subscribed packet size for the virtual 
circuit. Values that may be specified are 64, 128, 256, and 512 bytes, and 
must be equal to or less than the size of the controller read buffer 
specification (COMLINK macro CNL =). The default size is 128-byte 


packets. 
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WINDOW 
A decimal number in the range | to 7 if modulo 8 is specified in the 
COMLINK macro, or | to 15 if modulo 128 is specified in the COMLINK. 
macro that specifies the subscribed window size. 


LOCNM 
1 to 15 characters (range 0 to 9) specifying the calling DTE address, the 
network address of the 4700. This number will be included in the call request 
and call accepted packets if specified. This parameter is not required for 
PVC. 


REMNM 
1 to 15 characters (range 0 to 9) specifying the called DTE network address. 
This number is included in the call request packet and must be specified 
when outgoing call is specified. This parameter is not required for PVC. 


CONID 
8 characters that specify the optional user connection ID or password. This 
ID is included in the user data field of the call packet. 


X25CIS , 
A decimal number in the range of 2 to 60 that specifies the station to receive 
all data contained in incoming call and call connected packets. If this 
parameter is not specified, X25CIS defaults to the station that issues the first 
STRCKT instruction. If the default station is station 1, the system monitor, 
the data is written to the log and ignored. 
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X25FAC 


This macro specifies the subscribed facility fields. Parameters specified in this 
macro are included in the call packet, and can be changed with the STRCKT 


instruction. 
Name Operation Operand 
label  X25FAC (THPTCL=(nnnn,mmmm)} — [,CUG=nn} 
,REVCHG = {| Y ] Ronen) 
N 
THPTCL 


nnnn is a decimal number specifying the throughput class from the DCE to 

- the 4700. mmmm is a decimal number specifying the throughput class from 
the 4700 to the DCE. The valid numbers are 75, 150, 300, 600, 1200, 2400, 
4800, and 9600. 


CUG 
A decimal number, in the range of 1 to 99, that specifies the closed user 
group (CUG) code. 


REVCHG 
Y specifies that the reverse charging facility applies to the logical channel. 
N specifies that the facility does not apply to the logical channel. 


RPOA 
Specifies that the recognized private operating agency facility applies to the 
logical channel. nnnn is a decimal number, in the range of 1 to 9999, that 
identifies the intermediate network. 
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CPGEN Assembly Error Messages 


CPGEN error messages are located in the JBM 4700 Finance Communiccation 
System Controller Programming Library. No additional error messages are 


required 


X.25 Additional Status 


for X.25. 


The error conditions described below are in addition to existing status found in 
the JBM 4700 Controller Programming Library, Volume 3. 


Status 


Bi 
x 


X‘0401’ 


X‘'0402’ 


X‘0404’ 


X‘0408' 


X‘0410’ 


X’0420' 


es oe 


Command reject: The packet size specified in 
STRCKT is larger than specified in CPGEN. 


Action: Change CPGEN to provide a larger 
packet size. 


STRCKT 
STRCKT | 
STRCKT 


Command reject: The Window size specified 
in STRCKT is too large for modulo 8. 


Action: Change CPGEN or STRLNK 
parameter to provide modulo 128. 


Command reject: An incoming call is 
specified in STRCKT and no incoming call has 
been received. 


Action: Correct CPGEN or STRCKT. 


Command reject: An outgoing call or PVC is 
specified and an incoming call has been 
received. 


Action: Correct CPGEN or STRCKT. 


STRCKT 


STRCKT 


Command reject: LOCNM-REMNM are 
requested to be included in the call packet 
and none are given or are specified 
incorrectly. 


Action: Correct CPGEN or STRCKT. 


Command reject: The link is not active. - STRCKT 


Action: \ssue a STRLNK. 
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Chapter 3. Operating Information 


This chapter contains information for using the X.25 system’s monitor, log 
message descriptions and the X.25 status they contain, and the meanings of the 
controller’s operator panel indicator for the X.25 link. 


Log Message 11 006 (Format 5) 
Format 5: 11 006 a b vwwvwwwwxxyyzz 
a=8. The log entry pertains to the X.25 link and circuit. 
b=0. Status pertains to an operational link. 
b=1. Status pertains to a STRLNK operation. 
b=2. Status pertains to a STPLNK operation. 
b=3. Status pertains to an operational circuit. 
b=4. Status pertains to a STRCKT operation. 
b=5. Status pertains to a STPCKT operation. 


The values of vvvv, wwww, Xx, yy, and zz are described in the following status 
charts. 
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Operational Link Status (B= 0) 


0290 


User 


02C1 


02C2 


02D2 


User 


Fvvv 


User 


7 . 
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Reason: 


4700 : 


Reason: 


4700 : 


_ Reason: 


4700 : 


Action : 


4700 : 


Reason: 


4700 : 


Reason: 


4700 : 


| | Status and User Procedures 


A diagnostic packet was received. 


None. 


Analyze the diagnostic code (yy) and explanation field (wwwwxx) - 
to determine the cause. See ‘’Diagnostic Codes” later in this . 


- chapter. wwwwxx contain the first three bytes of the packet in 


error sent from the 4700. 
A packet has been discarded. 
None. 


Analyze the diagnostic code (yy) to determine why the ‘packet was 
discarded. See ‘’DTE— Generated Diagnostic Codes.’’ 


A Frame Reject (FRMR) has been received. 


A DISC has been sent, the link and circuit have been stopped and 
the link was restarted. 


Report the condition for servicing. The SVC circuit may be 
restarted. 


A Frame Reject (FRMR) has been sent due to an error in a received 
\-Frame. 


A DISC has been sent, the link and circuit have been stopped. 
The link and circuit (if a PVC) is restarted. 


Report the condition for servicing. The SVC circuit may be 
restarted. 


A packet level RESTART has been received. 


The link and circuit have been stopped and the link was 
restarted. A PVC circuit may also be restarted. 


The Diagnostic code (yy) indicates the cause of the restart. See 
‘‘DCE — Generated Diagnostic Codes.’’ An SVC circuit may 
be restarted. 7 


A packet level RESTART has been sent due to an error. 


The link and circuit have been stopped and the link was 
restarted. A PVC circuit may also be restarted. 


The Diagnostic code (yy) indicates the cause of the restart. 


See ‘‘DTE — Generated Diagnostic Codes.’’ An SVC circuit 


may be restarted. 


An unexpected or out of sequence event occurred. 


The circuit and link have been stopped. 


: Report the condition for servicing. The link and circuit can be 


restarted. 


STRLNK Status (B= 1) 


Reason: 


4700 : 


User 


| Status and User Procedures 


The STRLNK has completed successfully. 


None. 


None. 


O02C5 Reason: 


4700 : 


User 


0438 Reason: 


4700 : 


User 


Fvvv } Reason: 


4700 : 


User 


A DM has been received in response to an SABM, indicating that 
the DCE is not ready to communicate. 


The link is restarted. 


If this status persists, determine why the DCE is not ready for 
communications. 


A link-level error condition exists that has not been cleared by 
retries. 


The link is stopped and restart was tried. 


Previous log messages indicate the nature of the problem, follow 
the specified action procedure. 


An unexpected or out of sequence event occurred. 
The link has been stopped. 


Report the condition for servicing. The link can be restarted. 
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STPLNK Status (B= 2) 


| | Status and User Procedures | 


0000 | Reason: The STPLNK has completed successfully. 


4700 : None. © 


User : None. 


Reason: DSR from the DCE has been interrupted. 
4700 : The link is stopped. 


User : Remove the external cable and install the wrap plug. Issue the 
' Wrap-One-Time command. A wrap failure indicates a problem 
internal to the 4700; begin service procedures. 


Reinstall the external cable and place ‘Test/Operate’ switch in the 
‘Test’ position. Issue the Wrap-One-Time command. A wrap failure 
indicates a cable problem; replace the cable. If the wrap is 
successful, the problem is with the cable connector or the DCE. 


042A Reason: The clocking from the DCE has been interrupted. 


4700 : The link is stopped. 


User : Remove the external cable and install the wrap plug. Issue the 
Wrap-One-Time command. A wrap failure indicates a problem 
internal to the 4700; begin service procedures. 


Reinstall the external cable and place ‘Test/Operate’ switch in the 
‘Test’ position. Issue the Wrap-One-Time command. A wrap failure 
indicates a cable problem; replace the cable. If the wrap is 

successful, the problem is with the cable connector or the DCE. 


042B Reason: A 4700 communications adapter problem has occurred. 


4700 : The link is stopped. 
User : Remove the external cable and install the wrap plug. Issue the 


Wrap-One-Time command. A wrap failure indicates a problem 
internal to the 4700; begin service procedures. 


Reinstall the external cable and place ‘Test/Operate’ switch in the 
‘Test’ position. Issue the Wrap-One-Time command. A wrap failure 
indicates a cable problem; replace the cable. If the wrap is 

successful, restart the link. 


0438 A link-level error condition exists that has not been cleared by 


retries. 
4700 : The link is stopped. 


Previous log messages indicate the nature of the problem; 
follow the specified service procedure. 
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| www Status and User Procedures 


Reason: A 4700 communications adapter problem has been encountered. 
4700 : The link is stopped. 


User : Remove the external cable and install the wrap plug. issue the 
Wrap-One-Time command. A wrap failure indicates a problem 
internal to the 4700; begin service procedures. 


Reinstall the external cable and place ‘Test/Operate’ switch in the 
‘Test’ position. Issue the Wrap-One-Time command. A wrap failure 


indicates a cable problem; replace the cable. If the wrap is 
successful, restart the link. 


If the problem persists, begin service procedures. 


Reason: An unexpected or out of sequence event occurred. 


4700 : The circuit and link have been stopped. 


User : Report the condition for servicing. The link and circuit can be 
restarted. 
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Operational Circuit Status (B= 3) 


Sov Status and User Procedures __ 


0288 Reason: An X\D without data was received. 


4700 . The circuit is stopped. 
User : Determine why no XID data was included. 


Reason: A reset packet has been received. 
4700 : The circuit is stopped and restarted. 


User : Analyze the cause (xx) code and diagnostic (yy) code to determine 
the cause of the reset. 


02D1 Reason: Aclear packet has been received. 
4700 : The circuit is stopped. 


User : Analyze the cause (xx) code and diagnostic (yy) code to determine 
the cause of the reset. 


02D3 Reason: Aclear/reset packet has been sent. . 
4700 : The circuit is stopped. 
User : Analyze the diagnostic code (yy) for cause of clear/reset. If cause 
is an LLC error, wwww contains the LLC header. If the cause 
was a OFRMR, wwwwxx contains the QFRMR information field. 


02D4 Reason: 200 seconds have elapsed without receiving a response to a 
clear/reset packet. 


4700 : The circuit is stopped. 

User : Stop and restart the link before restarting the circuit. 
— Fvvv Reason: An unexpected or out of sequence event occurred. 

4700 : The send and link have been stopped. 


User .: Report the condition for servicing. The link and circuit may be 
restarted. 
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STRCKT Status (B= 4) 


0000 


0292 


02D1 


02D3 


02D4 


O02D5 


O40F 


041C 


Reason: 


4700 : 


User 


Reason: 


Reason: 


4700 : 


User 


Reason: 


4700 : 


User: 


Reason: 


4700 : 


User 


Reason: 


Reason: « 


4700 


User 


Reason: 


4700 : 


User 


Status and User Procedures | | 


The STRCKT completed successfully. 
None. 
None. 


A call request packet has been received that is larger than the 
buffer reserved for the packet. 


Complete STRCKT and present the data to the user. 
Define a larger buffer. 

A clear packet has been received. 

The circuit is stopped. 


Analyze the cause (yy) code and diagnostic (zz) code to determine 
the cause of the clear. 


A clear/reset packet has been sent. 
The circuit is stopped. A PVC circuit may be restarted. 


Analyze the cause (yy) code and diagnostic (zz) code to determine 
the cause of the clear/reset. 


200 seconds have elapsed without receiving a response to a clear 
packet. 


The circuit is stopped. 


The link must be stopped and started before the circuit can be 


- Started. ‘ 


A reset packet has been received within the time specified in 
OPTM. : 


The circuit is stopped. 


Restart the circuit. 


The circuit is in an invalid state. This condition occurs if an 
incoming call packet is received and a STRCKT is not issued 
before the DCE times out. 


The circuit is stopped. 


Investigate why the AP is not issuing, or delaying, a STRCKT 
when an incoming call is received. 


No channel is available for a STRCKT specifying an outgoing call. 
This occurs if a STRCKT has already been issued, there was a 
timeout on a previous STRCKT, or the channel is currently being 
cleared. 


The circuit is stopped. 


Previous log messages may indicate which of the above are 
causing the problem. If a previous STRCKT has been issued, then 
correct the program. For the other problems, issue a STPCKT, wait 
one minute and issue a STRCKT. 
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Status and User Procedures. 


The Logical Channel Number (LCHNI) specified in the STRCKT was 
not specified during CPGEN. 


The circuit is stopped. 

Correct the LCHNI. 

The PVC channel is inaaestige due to a timeout. 
The circuit is stopped. 

Stop and restart the link, followed by the STRCKT. 
The link has been Paes due to a previous error. 
The circuit is stopped. 

Stop and restart the link, followed by the STRCKT. 
An unexpected or out of sequence event occurred. 
The circuit and link have been stopped. | 


Report the condition for servicing. The link and circuit may be 
restarted. 
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STPCKT Status (B= 5) 


| vw Status and User Procedures 


The STPCKT completed successfully. 


None. 

None. 

An unexpected or out of sequence event occurred. 
The circuit and link have been stopped. 


Report the condition for servicing. The link and circuit may be 
restarted. 


Controller Log — 11 006 Log Message, Format 6 


Format 6: 11 006 A B XXX...XXX 


A=9. Data has arrived for the X25CIS, but the X25CIS is unavailable (the 
System monitor is currently the X25CIS or the X25CIS was not generated 
for the link). 


B=0. XXX...XXX contains data from an incoming call packet. 


B=1. XXX...XXX contains data from a call connected packet. 


OP Panel Indicator 


The operator panel indicator for the X.25 communication link will contain one 
of the following: 


There is a configuration mismatch, and no link module has been loaded. 
A link module has been loaded. 

A wrap failure has occurred. 

The Communication Link has failed. 


A STPLNK has been issued. 

A STPCKT has been issued. 

A STRLNK has been issued. 

A STRCKT has been issued. 

Contact has been established with the DTE. 

The SNA System Services Control Point session has been established. 
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X.25 Cause and Diagnostic Codes 


The following charts describe the one-byte cause and one-byte diagnostic code 
fields that are included in the clear, reset, and restart packets. 


DCE-Generated Cause Codes 


Clear Indication Packet : | 


Remote DTE passed diagnostic code 
Number busy 

Invalid facility request 

Network congestion 

Number out of order 

Access barred 

Not obtainable 

Remote procedure error 

Local procedure error 

RPOA out of order 

Reverse charging acceptance error 
Incompatible destination 

Fast Select acceptance error 


Reset Indication Packet 


Remote DTE passed diagnostic code 
Out of order (PVC only) 

Remote procedure error 

Local procedure error 

Network congestion 

Remote DTE operational (PVC only) 
Network operational (PVC only) 
incompatible destination 


Restart Indication Packet 


Local procedure error 
Network congestion 
Network operational 
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DCE-Generated Diagnostic Codes 


No additional information 
Invalid Packet Send Sequence Number 
Invalid Packet Receive Sequence Number 


Packet type invalid - general 
for state R1 
for state R2 
for state R3 
for state P1 
for state P2 
for state P3 
for state P4 
for state P5 
for state P6 
for state P7 
for state D1 
for state D2 
for state D3 


Packet not allowed - general 
unidentifiable 
call on One-way logical channel 
invalid packet type on PVC 
packet on unassigned channel 
REJECT not subscribed to 
packet too short 
packet too long 
invalid General Format identifier (GFi) 
RESTART with non-zero GFI 
Packet type incompatible 
unauthorized INTERRUPT confirmation 
unauthorized INTERRUPT 


Timer expired — general 
INCOMING CALL 
CLEAR INDICATION 

RESET INDICATION 

RESTART INDICATION 


Call setup problem — general 
facility code not allowed 
facility parameter not allowed 

invalid call address 

invalid calling address 
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DTE-Generated Diagnostic Codes 


Normal or termination | 


Invalid packet type — general 
for state R1 
for state R2 
for state R3 
for state P1 
for state P2 
for state P3 
for state P4 
for state P5 

_ for state P6 
for state P7 
for state D1 
for state D2 
for state D3 


DCE timer expired — general 
INCOMING CALL 
CLEAR INDICATION 
RESET INDICATION 
RESTART INDICATION 


DTE timer expired — general 
CALL REQUEST 
CLEAR REQUEST 
RESET REQUEST 
RESTART REQUEST 


QLLC error — general 
undefined C-field 


unexpected C-field 

missing |-field 

undefined I-field 

I-field too long 

QFRMR received 

Invalid OQLLC header 

QLLC data received in non-data state 


PSH error — general 
sequence error 
invalid PS header 
invalid PSH format 
invalid PS command 
invalid PSH protocol 
PSH data received in non-data state 


Packet not allowed 

invalid M-bit packet sequence 
invalid packet type received 
invalid packet on PVC 
unassigned logical channel number 
diagnostic packet received 
packet too short 

packet too long 

invalid GFI 

not identifiable 

not supported 

invalid P (S) 

invalid P (R) 

invalid D-bit received 

invalid Q-bit received 
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DTE-Generated Diagnostic Codes (continued) 


termination pending 
channel inoperative 
unauthorized interrupt confirmation 
unauthorized interrupt request 

PVC resource not available 


Resources - general 
buffers depleted 
PIU too long 


Local procedure error — general 
packet received with LC 7=0 
RESTART or DIAG received LC 7=0 
incoming call received on wrong LC 
facility not subscribed 
invalid packet for LC = 0 
facility parameters not supported 
facility not supported 
unexpected calling DTE 
invalid D-bit request 
reset indication on virtual call 
invalid protocol identifier 
connection identifier mismatch 


Remote procedure error — general 
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X.25 Statistical Counters 


Link Counters 


X.25 provides statistical data in two groups of counters that a key operator can 
read using the system monitor. This section describes the meaning of those 


counters. 


The first group of counters are the link counters. These counters replace the 
normal SDLC host link counters on an X.25 system. Remote operators can read 
some of the X.25 link counters through the IBM Communications Network 


-Monitor/Controller Support (CNM/CS) function. CNM/CS does not read all 


X.25 link counters, however, and the counter numbers of those read are different 
from the normal numbers. The following list of X.25 link counters shows the 
link counter number followed by, where applicable, the CNM/CS number in 
parentheses. The second part of the list contains the counter description. 


Counter: 


1 


4 (1) 


10 


11 (10) 


12 


13 (9) 


14 (13) 


15 


16 
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Description: 
Set Asynchronous Balance Mode (SABM) received. The controller received 
SABM from the DCE after completing the normal start sequence, and returned a 


DISC to stop the link operation. 


Test message received. The controller received a link test message. 


Reserved 


Receive has timed out. The controller did not receive a valid frame within the 
time specified by INPT. The controller stops the link and circuit, then tries a 
restart. 

Reserved 


Reserved 


Write Timeout. DCE clocking was interrupted. The controller stops the link and 
circuit and attempts a restart. 


Invalid hardware status. The controller detected a communications adapter 
problem. The controller stops the link and circuit and attempts a restart. 


Reserved 
Reserved 


DCE hardware error. The Data Set Ready signal from the DCE was interrupted. 
The controller stops the link and circuit and attempts a restart. 


Reserved 


Sequence number error. The controller received more than one I-frame with the 
same send sequence number. The controller stops the link and circuit and 
attempts a restart. 


Adapter machine check. The controller detected a communications adapter 
problem, stopped the link and circuit, and tried to restart. 


The controller sent Frame Reject (FRMR) to indicate an I-frame error was 
received. The controller follows FRMR with DISC, stops the link and circuit, and 
attempts a restart. 


Packet discarded. Analyze the diagnostic code in the 11 006 a b 0290 log 
message to find the reason. 


Circuit Counters 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 
27 
28 
29 


30 (6) 


31 


32 


Exchange ID (XID) was received. 


The controller received a diagnostic packet. Analyze the diagnostic code in the 
11 006 a b 0290 log message to find the reason. 


Frame Reject (FRMR) was received. The controller sends a DISC, stops the link 
and circuit, and attempts a restart. 


DCE unavailable. The controller received a DM response to SABM, indicating that 
the DCE cannot communicate. The controller attempts a restart. 


Unexpected unsequenced acknowledgement (UA) was received. The controller 
sends DISC, stops the link and circuit, and attempts a restart. 


The controller received a packet-level restart, and responds by stopping the link 
and circuit and attempting restart. Analyze the 11 O06 a b O2D3 log message to 
find the cause. 

The controller sent either a reset, clear, or restart packet in response to an 

error. The controller stops and then restarts the link and circuit. Analyze the 


diagnostic code in the 11 006 a b 02D3 log message to find the cause. 


200 seconds passed without the controller receiving a response to a restart. 
The controller stops and restarts the link and circuit. 


The controller deferred an adapter-level function because a previous function 
was incomplete. The controller recovers without errors being logged or counted. 


The controller attempted a link operation, but the link was not open. 

A previously reported hardware error prevented a later function from completing. 
The controller tried to open a link that was already open. 

A condition requiring STPLNK or STPCKT to be excuted cannot be completed. 


The controller detected a link-level error condition that was not corrected by 
retrying. The controller stops the link and circuit and attempts a restart. 


The controller received a DISC and responded by sending an unsequenced 
acknowledgement (UA), stopping the link and circuit, and attempting a restart. 


The controller detected an unexpected or out-of-sequence event and stopped 
the link and circuit. No restart was attempted. 


The following one-byte counters define X.25 circuit conditions. The application 
program should reset these counters before issuing STRCKT. These counters 
cannot be read directly by CNM/CS. 


Counter: 


Description: 
Exchange ID (XID) received. 


Test message received. The controller received a link test message for this 
circuit. 


Set Normal Response Mode (SNRM) was received. 


Set Disconnect Response Mode (SDRM) was received. 
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10 


11 


12 
13 


14 
15 
16 


17 
18 
19 


20 


21 


22 


23 


24 
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The controller received a call request packet that was too large for the packet 
buffer. 


A count indicates the remote DTE answered a STRCKT with operational status, 
and is ready to receive data. 


(SVC Open Circuit only) The flow control negotiation parameters received in the 
call connected packet do not match those sent in the STRCKT parameter list. 


The stop failed. No error occurs, and the controller restarts the operation. 


The controller received a reset packet and stopped the circuit. Analyze the 
11 O06 a b O2D0 log message for the cause. 


The controller received a clear packet and stopped the circuit. Analyze the 


11 006 a b 02D1 log message for the cause. 


The controller sent either a reset, clear, or restart packet in response to an error. 
The controller stops the link. Analyze the diagnostic code in the 
11 006 a b 02D3 log message to find the cause. 


200 seconds passed without the controller receiving a response to a clear or 
reset packet. 


The controller deferred an adapter-level function because a previous function 
was incomplete. The controller recovers without errors being logged or counted. 


The controller attempted a circuit operation but the circuit was not open. 
A previously reported hardware error prevented a later function from completing. 
The controller tried to open a circuit that was already open. 


The controller deferred an adapter-level function because a previous function 
was incomplete, requiring the link and circuit to stop. 


The circuit received an incoming call packet, but no STRCKT was issued before 
the DCE timer ran out. The circuit is stopped. 


There is no channel available for the outgoing call packet. The circuit attempts to 
restart. 


The STRCKT logical channel number was not defined during configuration. 


The PVC channel cannot operate because of a timeout condition. The circuit 
stops. 


A previous error or other condition stopped the link. 


The circuit received no response to a call request within the time specified in 
OPTM. The circuit tries to restart. 


Reserved 


System Monitor Functions 
Display Statistical Counters (CMD 010) 


This command will display the statistical counters for the circuit, the link, or the 
hardware registers. The format of the command is: 


010 90x1 
where: 


x = 0 to display link counters 
1 to display circuit counters 


The formats of the counters are: 


If the circuit counters are requested, 24 counters are displayed in decimal. 
See ‘‘Circuit Counters’’ for the definition of each counter. 


If the link counters are requested, 32 counters are displayed in decimal. See 
‘‘Link Counters’’ for the definition of each counter. 


Print Statistical Counters (CMD 012) 


This command will print all counters and registers for X.25. See the 010 
command for format of the output. 


Start/Stop the Circuit (CMD 141) 


This new command allows the user to start or stop the Circuit. The format of the 
command is as follows: | 


141 x flag2 flag3 Ichni confg1 config2 locnm remnm 
cug rpoa thptcl ofac cid 


Note: It is possible to obtain the existing circuit parameters by setting flag3 to 01 
(141 0 01); no other parameters are required. 


The following parameters are required to start a circuit: 
x flag2 flag3 Ichni. 
where: 


X = O Start the circuit. 
1 Stop the circuit. 


All other parameters are optional and may be specified in groups. If the first 
parameter of a group is specified, the others of that group must be specified. 
There are four groups of parameters: 


(config1l config2) 
(locnm remnm) 

(cug rpoa thptcl ofac) 
(cid) 
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If a particular group is specified, then all previous groups are required. For 
example: if the third group is specified, then all the previous parameters in 
groups 1 and 2 must be specified. 


flag2 
Two hexadecimal characters that describe circuit parameters. 


‘Bit Explanation 


0 O=do not start this circuit automatically in the future. 
1=start the circuit automatically in the future. 


1 O=default the flag3 values. 
1=use flag3 as specified. 


6 O=start the Circuit. 
1=turn off the automatic start circuit flag. — 


7 O=start circuit. | 
1=do not start circuit but return existing parameters. 
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flag3 
Two hexadecimal characters that describe the inclusion of fields in call 
packets. 


Bit Explanation 
0. 0 =do not include Flow Control Negotiation parameters in the call packets. 
1 =include Flow Control Negotiation parameters. 
1 0 =do not include LOCNM in the call packets. 
1 =include LOCNM. 
2 O =do not include REMNM in the call accepted packet. 
1 =include REMNM (required for outgoing calls). 
3 0 =do not include CUG in the call packet. 
1 =include CUG. 
4 O =do not include RPOA in the call packets. 
1 =include RPOA. 
5 O =do not include THPTCL in the call packet. 
1 =include THPTCL. 
6 O=do not include OFAC in the call packet. 
1 =include OFAC. 
7 0 =do not include CID in the call packet. 
1 =include CID. 


Example: To include flow control negotiation parameters and CID in the call 
packet: 


ENTER — 81 


Ichni 
A 3-digit number that specifies the logical channel group number (0 to F) 
and the logical channel number (00 to FF). 


In the following format: 
Xyy 
X — Logical channel group number 
YY — Logical channel number 
Example: To enter group channel number 13, channel number 128: 
ENTER — D80 
confg1 


Two hexadecimal characters that specify the packet size, LLC, and type of 
circuit; switched or permanent. 


Note: The command will complete with status X‘0401’ if the packet size is 
greater than that specified in the X2SCKT configuration macro. 


Bit Explanation 


if 00=128 10=256 01=64 #11=512 


Reserved 
1=Permanent 0=Switched 


2 
3 

<I 10=PSH 11=QLLC 
5 

7 


Reserved 
Reserved 
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confg2 
Two hexadecimal characters that specify the type of switched call and 
window size. 


Note: The command will complete with status X‘0402’ if the window size is 
specified greater than 7 and the modulo is specified as 8. 


Bit Explanation 
0 { 0=Outgoing call 
- 1=Incoming call 
1 Reserved 
2 Reserved 
3 Reserved 
4 Window size 
5 X'1' to X’7' if modulo 8 specified 
6 X'1' to X'F’ if modulo 128 specified 
7 Reserved | 
locnm 


One to 15 characters that contain the calling DTE number. 


remnm | 
One to 15 characters that contain the called DTE number. 
cug | 
A number specifying the two-digit group code (specified as two hexadecimal 
digits). | 


rpoa 
The four-digit number of the intermediate network. 


thptcl 
A two-character hexadecimal number specifying the throughput class. 


DCE to 4700 4700 to DCE 

Bit O01 2 3 4567 Hex 
001 1 75 001 1 3 
0100 150 0100 4 
0101 300 010 1 5 
0110 600 0110 6 
011 1 1200 011 1 7 
1000 2400 100 0 8 
100 1 4800 100 1 9 
101 0- 9600 1010 A 


Example: To specify DCE to 4700 of 9600 and 4700 to DCE of 4800: 
ENTER — A9 (10101001) 


ofac 
Specifies the optional facilities requested. 


00 — No reverse charging 

01 — Reverse charging 
cid | i 
Eight characters that specify the connection ID. This ID is placed in the - 
user data field of a call packet. 
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Start/Stop the Link (CMD 041) 


The format of the command for an X.25 communications link is as follows: 
041 x yy zz cc xff aaaaa x25flg tmrl inpt rspt rexm optm 

pvclei oclci twlei iclci 

where: 

x yy zz cc xff aaaaa 

is the same for all link types. 


X25flg 
A 1-byte field that indicates if modulo 128 packet level sequence numbering 
is to be used. 


bit 2=1 for UKPSS or TELENET network. 

bit 3=1 for modulo 128 packet level sequence numbering. 
bit 4=1 for DDXP 

bit 7=1 to return existing link parameters. 


inpt 


A decimal number that specifies the idle/non-productive timeout value. 
(Values 0 - 99) 


rspt 
A decimal number that specifies the regional timeout value (0 - 20). 


rexm | 
A decimal number that specifies the retransmission timeout value 
(Values 0 - 99). 

optm 
A decimal number that specifies the connection establishment timeout value 
(Values 0 - 7). 

pvelci 
A 3-digit number that specifies the logical channel group number (0 to 15) 
and the logical channel number (0 to 255) of the channel reserved by the 
network for the PVC. 
In the following format: 


Xyy 


x — Logical channel group number 
yy — Logical channel number 


Example: To enter group channel number 13, channel number 128: 


ENTER — D80 
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oclci | 
A 3-digit number that specifies the logical channel group number (0 to 15) 
and the logical channel number (0 to 255) of the channel reserved by the 
network for outgoing calls. 
In the following format: 


Xyy 


x — Logical channel group number 
yy — Logical channel number 


Example: To enter group channel number 13, channel number 128: 
ENTER — D80 

twlei 
A 3-digit number that specifies the logical channel group number (0 to 15) 
and the logical channel number (0 to 255) of the channel reserved by the 
network for two-way calls. 
In the following format: 


XYY 


x — Logical channel group number 
yy — Logical channel number 


Example: To enter group channel number 13, channel number 128: 
ENTER — D80 

iclei 
A 3-digit number that specifies the logical channel group number (0 to 15) 
and the logical channel number (0 to 255) of the channel reserved by the 
network for incoming calls. 
In the following format: 


Xyy 


x — Logical channel group number 
yy — Logical channel number 


Example: To enter group channel number 13, channel number 128: 
ENTER — D80 


Startup 


The monitor will support a new code defined in the GMSLID field to indicate the 
X.25 link. The value will be X‘09’. 
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Chapter 4. Storage Requirements 


The values listed for the storage requirements are in addition to the factors 
calculated for the basic 4700 controller. Consult the JBM 4700 Finance 
Communication System Configurator, GC31-2017, to determine the storage 
requirements. 


Controller Data Requirements 


CPGEN Requirements 


The additional controller data storage required when the X.25 link is 
included is 25K. 


The additional CPGEN storage required for the X.25 link is as follows: 


@ “For the-X 25 HK ase obs 6 OS Gh ONS RE D4 SRE ee 2064 bytes 
plus 4 X (packet size + 16) (default) ....... sala cor irks Achaea 576 bytes 
e For each logical channel specified ........... 0... cece eee ee eens 32 bytes 
e §6For each controller read buffer specified........ eee e eee eee ees 8 bytes 
Example: 
X.25 link...... poi ceva inea Guathadek arose teenaes ae 2064 
Packet Size 128 css oss nt hoe eee eee 576 
1 logical channel ............ 0.0.00 eee Sug oe 
STEad DULIClS xcs bs awanteew.setexecees aatae 24 
Total storage required...... ica Deere chamragrat at 2696 
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Glossary 


This glossary defines System Network Architecture 
(SNA) terms as they apply to SNA-Primary. This 
glossary elaborates on or qualifies those basic 
definitions. For other definitions, the reader should 
refer first to the appropriate section of this manual, 
then to either the JBM Vocabulary for Data 
Processing, Telecommunications, and Office Systems, 
GC20-1699, or to the prerequisite publications listed 
at the beginning of this manual. 


application program (AP). The 4700 program that resides in 
Segment 14 of a work station and performs work on behalf of that 
station. 


application program interface (API). The boundary between the 
application program and the 4700 controller that comprises 
instruction parameters, status fields, and global flags. 


circuit information station. The station which has been selected to 
receive all data contained in incoming call and call connected 
packets. 


closed user group (CUG). A restricted access subset of an X.25 
network. Identified by a two-digit group code. 


connection ID (CID). The eight character identification name 
which is included in the user data field of a call packet. 


(CPU). The host processing system. 


data terminal equipment (DTE). A host controller or terminal. 


(DCE). Data circuit-terminating equipment. 


flow control parameter negotiation (FCPN). The network 
subscription option that allows packet size and window size values 
to be included in call packets. 


frame reject (FRMR). A response used to report error conditions 
that are not recoverable by retransmission. 


incoming call logical channel identifier (ICLCD. The logical 
channel group number and logical channel number of the channel 
reserved by the network for an incoming call circuit. 


international telegraph and telephone consultative committee 


(CCITT). 


link access protocol balanced (LAPB). The link access procedure 
used in IBM’s implementation of X.25. 


logical channel identifier (LCI). The logical channel group number 
and the logical channel number of a channel reserved by the 
network for a virtual circuit. 


logical channel number (LCN). A decimal number in the range of 
0 to 255 that identifies a particular channel within a group. 


logical link control (LLC). Either QLLC or PSH. 


logical unit (LU). One of three network addressable units (the 
others are physical unit and system services control point), and the 
port through which an end user accesses function management in 
order to communicate with another end user. A logical unit must 
support two sessions — one with the system services control point, 
the other with the other end user’s logical unit. 


network identification field (NID). The identifier, also known as 
the network address or network name, by which end users refer to 
a network addressable unit (NAU). You must define NIDs for each 
SNA-Primary line, control unit, and terminal with the NETID 
parameters of the ALACU, ALATERM, and ALALINE 
configuration macros during the configuration (CPGEN) process. 


outgoing call logical channel identifier (OQCLCI). The logical 
channel group number and logical channel number of the channel 
reserved by the network for an outgoing call circuit. 


permanent virtual circuit logical channel identifier (PVCLCI). The 
logical channel group number and logical channel number of the 
channel reserved by the network for a permanent virtual circuit. 


physical services header (PSH). A link control procedure used by 
some initial IBM DTE’s to perform adjacent node services and 
segmentation/concatenation. 


physical unit (PU). One of three types of network addressable 
units (the others are the logical unit and system services control 
point). The physical unit (PU-T1, PU-T2, or PU-TS) at each node 
controls the resources for that node. 


primary logical unit (PLU). An SNA access port containing the 
primary half of an LU-LU session. A controller or controller-level 
device may contain program support that allows it to act as both a 
PLU when working with one or more secondary logical unit (SLU) 
devices, and as an SLU when working with another PLU device | 
higher in the chain. 


(PSDN). Packet-switched data network. 


(PVC). Permanent virtual circuit. 


qualified logical link control (QLLC). The logical link control level 
used in IBM’s implementation of X.25. 
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receive not ready (RNR). A packet sent by either a primary or 
secondary station to indicate a temporarily busy condition. 


receive ready (RR). A packet that indicates the originating station 
is ready to receive. 


(RPOA). Recognized private operating agency. 


(SDLC). Synchronous data link control. 

(SDRM). Set disconnect response mode. 

secondary logical unit (SLU). An SNA access port containing the 
secondary half of an LU-LU session. Contrast with primary logical 
unit (PLU). 

set asynchronous balanced mode (SABM). An unnumbered 
command used by transmitting stations to place the remote station 
in information transfer phase. 


(SNA). System network architecture. 


(SNRM). Set normal response mode. 
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(SVC). Switched virtual circuit. 


system services control point (SSCP). A network addressable unit 
(NAV) that provides configuration, maintenance, management, and 
session services between physical units, logical units, and other 
SSCPs. The 4700 controller contains some of the physical unit-type 
5 (PU-T5) functions necessary to support an SSCP. The application 
program must provide the remaining SSCP support. 


two-way logical channel identifier (TWLCI). The logical channel 
group number and logical channel number of the channel reserved 
by the network for two-way call circuits. 


(UA). Unnumbered acknowledgement. 
(VTAM). Virtual telecommunications access method. 


(XID). Exchange station ID. 
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